[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
Related Topics: - !Seealso: (Cross Referencing).
Purpose
Seealso references allow you to jump from one related long entry to
another other long entries. If there are any !seealso's defined for
a long entry, Related Topics: will appear in the top left corner
of the long entry window. When ENTER is pressed, a pull-down menu
will appear with the names of the references as menu items. Scroll to
the topic of your choice and press ENTER. The new topic will appear
instantly on your screen. To define a !seealso: reference follow the
examples below.
Format:
!seealso: key-word(s) [space...keyword(s)]
Where
key-word(s) is one of the following:
text-from-a-short-entry
or
filename.ngo:text-from-a-short-entry
or
filename.ngo:seealso-title
Notes:
!seealso:, like all other bang commands, must be typed starting in
the leftmost screen column.
The text-from-a-short-entry must appear at the start of the entry
that expands to the long entry you want. The text can be any number of
words, starting at the beginning of the short entry, and ending with a
space or tab. The short entry can be either in the current data text
file, or another data text file.
The third format of !seealso: allows you to include a reference to any
long entry that's by itself. In this case, there's no short entry from
which to draw text for the Related Topics: menu, so you simply make
up the text for seealso-title. The Engine then puts the seealso-title
in the Related Topic menu.
A table is often implemented as a long entry directly off a menu item,
and is thus in a file by itself. You can use this format to incorporate
a !seealso reference to such a table.
Description
The !seealso: command moves the user to another long entry. The text
after !seealso: comes from a short entry; when the user highlights that
text in the Related Topics: menu and presses Return, he is taken
automatically to the long entry that lies underneath the highlighted
short entry.
You do not need to use the entire text of the short entry. For example,
if the long entry you are referring to is under a short entry that
reads:
!short: Close Procedure Closes an active procedure file.
your seealso could read:
!seealso: "Close Proc"
or
!seealso: "Close Procedure"
Note:
You need only include enough text to uniquely identify the short
entry. The text must, however, be taken from the beginning of the
entry.
Multiple references in a single !seealso: command are separated by one or
more spaces or tabs. If the key-words text includes embedded spaces,
tabs, or colons, it must be enclosed within double quotation marks. Use
two quotations marks to enter a single quotation mark into the key-words
itself.
The key-words text can come from a short entry either in the same file,
or in a different file. To indicate a reference to a short entry in
another file, precede the key-words text with the filename, as in:
!seealso: ascii.ngo: "ASCII CHART"
See Also:
An Overview of Database Design.
System Requirements.
Hypertext Databases (specs)
Expert Help Engine
Character Attributes
Comments
!Credits:
Data Text Files.
!File:
Long Entries
!Short:
The Menu Link Control File.
!Name:
The Search Engine (EH.EXE)
The Database Composer
!Menu:
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson